Skip to content

chore(release): prepare v1.14.0#508

Merged
ajitpratap0 merged 1 commit intomainfrom
release/v1.14.0-prep
Apr 11, 2026
Merged

chore(release): prepare v1.14.0#508
ajitpratap0 merged 1 commit intomainfrom
release/v1.14.0-prep

Conversation

@ajitpratap0
Copy link
Copy Markdown
Owner

Summary

Prepares the v1.14.0 release across all shipping surfaces: library, CLI, MCP server, VS Code extension, WASM playground, website, docs, and Python bindings.

Headline features:

  • Dialect-aware SQL formatting (closes [FEATURE] Dialect aware transform package implementation #479): transform.FormatSQLWithDialect() renders TOP/FETCH FIRST/LIMIT per dialect
  • Snowflake: 100% of QA corpus (87/87): MATCH_RECOGNIZE, @stage, SAMPLE, QUALIFY, VARIANT paths, time-travel, LATERAL FLATTEN, TRY_CAST, and more
  • ClickHouse: 83% of QA corpus (69/83, up from 53%): nested types, parametric aggregates, WITH FILL, CODEC, SETTINGS/TTL, table/partition as identifiers (closes [BUG] multiple errors in ClickHouse dialect #480)
  • MariaDB dialect: SEQUENCE DDL, temporal tables, CONNECT BY
  • SQL transpilation: MySQL↔PostgreSQL, PostgreSQL→SQLite + gosqlx transpile CLI subcommand
  • Live schema introspection: Postgres, MySQL, SQLite loaders
  • Linter: 10 → 30 rules (safety, performance, naming categories)
  • Integrations: OpenTelemetry and GORM sub-modules

What's in this PR

Version bumps across all components:

  • Library pkg/gosqlx: 1.14.0
  • CLI cmd/gosqlx: 1.14.0
  • MCP pkg/mcp/server: 1.14.0
  • VS Code extension: 1.14.0
  • glama.json: 1.14.0 + MariaDB/ClickHouse added to dialect list
  • performance_baselines.json: 1.14.0 (2026-04-12)
  • Python bindings pygosqlx: 0.2.0 (independent alpha semver track)

CHANGELOG + docs:

  • [1.14.0] - 2026-04-12 section with full audit of 30+ merged PRs
  • docs/MIGRATION.md: v1.13 → v1.14 guide with new APIs and behavioral notes
  • docs/GETTING_STARTED.md: refreshed feature highlights, CLI list, 8-dialect support
  • docs/SQL_COMPATIBILITY.md: per-dialect status with honest QA pass rates
  • examples/README.md: fixed stale v1.6.0 → v1.14.0

QA corpus committed (qa build tag, excluded from normal CI):

  • pkg/sql/parser/clickhouse_qa_test.go: 83 queries, 69 pass
  • pkg/sql/parser/snowflake_qa_test.go: 87 queries, 87 pass

WASM rebuilt:

  • wasm/playground/gosqlx.wasm + website/public/wasm/gosqlx.wasm

Website copy:

  • Hero badge: v1.14.0 - Multi-Dialect SQL Parser
  • Benchmarks page: Last updated: April 2026 · Based on v1.14.0

Verification

  • go test -race -timeout 300s ./... — all 37 packages pass
  • go vet ./... — clean
  • gofmt -l pkg/ cmd/ — clean
  • TestPerformanceRegression: 5/5 baselines pass, 25-38% faster than v1.13.0
  • CLI build + gosqlx --version1.14.0
  • CLI smoke tests: validate, validate --dialect sqlserver, transpile --from mysql --to postgresql, format, lint all work
  • MCP stdio handshake returns "version":"1.14.0"
  • LSP initialize handshake returns full capabilities
  • WASM rebuilds cleanly for both wasm/playground/ and website/public/wasm/
  • Snowflake QA: 87/87
  • ClickHouse QA: 69/83 (known gaps documented in CHANGELOG for v1.15)

Not in this PR (follow-up work)

  • Integration sub-module bumps (integrations/opentelemetry/go.mod, integrations/gorm/go.mod): these require the v1.14.0 tag to exist first (chicken-and-egg), so they ship as a follow-up PR after the release tag lands
  • VS Code marketplace publish: handled by the vscode-publish.yml workflow after tag push
  • Glama MCP registry: auto-syncs via glama-sync.yml on GitHub Release

Test plan

  • CI green on this PR (lint, test, security, integrations, scorecard)
  • After merge: tag v1.14.0 from main, confirm release.yml goreleaser produces binaries for all OS/arch targets
  • Confirm GitHub Release is created with CHANGELOG header
  • Follow-up PR: bump integrations/*/go.mod to v1.14.0

Closes #479
Closes #480

🤖 Generated with Claude Code

Cut v1.14.0 release across all shipping surfaces:

Library & CLI:
- pkg/gosqlx: const Version = "1.14.0"
- cmd/gosqlx: CLI version 1.14.0, updated feature list in help
- pkg/mcp: MCP server handshake reports 1.14.0
- Full dialect list in CLI help (8 dialects)

Companions:
- vscode-extension: 1.14.0 (tracks library)
- glama.json: 1.14.0 + MariaDB/ClickHouse in dialect list
- python/pygosqlx: 0.2.0 (independent alpha track)
- integrations/{opentelemetry,gorm}: bumped post-tag in Phase 6
- WASM: rebuilt for both wasm/playground and website/public/wasm

Docs:
- CHANGELOG: [1.14.0] - 2026-04-12 with full PR audit (30+ PRs)
- MIGRATION.md: v1.13→v1.14 section with new APIs and behavioral notes
- GETTING_STARTED.md: v1.14 feature highlights, 30-rule linter, 8 dialects
- SQL_COMPATIBILITY.md: Snowflake 87/87 and ClickHouse 69/83 with gaps
- examples/README.md: stale v1.6.0 -> v1.14.0

Benchmarks:
- performance_baselines.json: refreshed to v1.14.0 (2026-04-12)
- All 5 baselines improved 25-38% over v1.13.0

QA corpus tests committed (qa build tag, excluded from normal CI):
- pkg/sql/parser/clickhouse_qa_test.go: 83 queries, 69 pass
- pkg/sql/parser/snowflake_qa_test.go: 87 queries, 87 pass

Verification:
- task check green (fmt + vet + test:race)
- All 37 library packages + CLI subcommands pass with -race
- Performance regression test: 0 failures, 0 warnings
- CLI, MCP (stdio), LSP smoke tests confirm 1.14.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
gosqlx-website Ready Ready Preview, Comment Apr 11, 2026 7:11pm

@github-actions github-actions bot added documentation Improvements or additions to documentation cli performance python parser wasm WebAssembly playground labels Apr 11, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 11, 2026

Claude finished @ajitpratap0's task —— View job


PR Review for v1.14.0 Release Preparation ✅

Comprehensive review of this release preparation PR for code quality, potential issues, performance considerations, security concerns, and test coverage.

Review Checklist:

  • Analyze version bumps across all components for consistency
  • Review CHANGELOG.md for completeness and accuracy
  • Examine new QA test files for quality and coverage
  • Check documentation updates for accuracy
  • Review configuration file changes (glama.json, performance baselines)
  • Verify WASM rebuild integrity
  • Assess security implications of changes
  • Check for potential performance regressions
  • Validate release preparation best practices

✅ Overall Assessment: APPROVED

This is a well-executed v1.14.0 release preparation with excellent attention to detail and comprehensive coverage across all shipping surfaces.

🎯 Strengths

Version Consistency

Perfect version alignment across all components:

  • Library: pkg/gosqlx/gosqlx.go:331.14.0
  • CLI: cmd/gosqlx/cmd/root.go:461.14.0
  • MCP: pkg/mcp/server.go:381.14.0
  • VS Code: vscode-extension/package.json:51.14.0
  • glama.json: line 9 → 1.14.0
  • performance_baselines.json: line 2 → 1.14.0 (2026-04-12)
  • Python bindings: 0.2.0 (independent alpha semver - appropriate)

CHANGELOG Quality

Excellent changelog with:

  • Clear headline themes and feature summaries
  • Proper issue closure references (#479, #480)
  • Detailed API documentation with code examples
  • Security fixes properly documented (CVE-2026-39883)
  • Performance improvements quantified (25-38% faster)
  • Deprecation warnings carried forward appropriately

QA Test Coverage

High-quality QA test implementation:

  • ClickHouse: 83 test cases (168 lines) - 69/83 passing (83% coverage)
  • Snowflake: 87 test cases (201 lines) - 87/87 passing (100% coverage)
  • Both properly tagged //go:build qa to exclude from CI
  • Comprehensive coverage of dialect-specific features (CTEs, window functions, DDL, DML)

Documentation Updates

Thorough documentation maintenance:

  • docs/MIGRATION.md: Comprehensive v1.13→v1.14 guide with API examples
  • docs/GETTING_STARTED.md: Updated feature highlights reflecting 8-dialect support
  • docs/SQL_COMPATIBILITY.md: Honest QA pass rates documented per dialect
  • examples/README.md: Version corrected from v1.6.0 to v1.14.0

Configuration Management

Well-maintained configuration files:

  • glama.json: MariaDB + ClickHouse added to dialect list
  • performance_baselines.json: Updated with realistic CI tolerances (60-65%)
  • WASM files: Properly rebuilt (7.54MB, identical timestamps)

🔒 Security Analysis

No Security Concerns Identified

  • CVE-2026-39883 (OpenTelemetry SDK) properly addressed in CHANGELOG
  • No secrets or credentials exposed in version bumps
  • QA test files contain only harmless SQL test cases
  • WASM rebuilds are clean and properly sized

Code Quality

  • Only one TODO found (pkg/sql/parser/clickhouse_test.go:63) - harmless test skip
  • No FIXME/HACK patterns in new code
  • Clean diff with appropriate changes only

🚀 Performance Considerations

Baselines Properly Updated

  • Performance baselines set with realistic CI runner tolerances
  • 25-38% improvements over v1.13.0 documented
  • Object pooling and zero-copy optimizations preserved
  • Sustained 1.38M+ ops/sec throughput maintained

📦 Release Preparation Best Practices

Excellent Release Hygiene

  • All shipping surfaces covered (library, CLI, MCP, VS Code, website, Python)
  • Website hero badge updated: v1.14.0 - Multi-Dialect SQL Parser
  • Benchmarks page updated: Last updated: April 2026 · Based on v1.14.0
  • Comprehensive verification checklist provided in PR description
  • Clear follow-up tasks identified (integration sub-modules post-tag)

📋 Recommendations

Minor Suggestions (Non-blocking)

  1. Test Organization: Consider moving the QA test suites to a dedicated testdata/ directory for better organization as corpus grows.

  2. Performance Monitoring: The 60-65% CI tolerance is high but reasonable given shared runners. Consider setting up dedicated performance tracking infrastructure for more stable baselines.

  3. Documentation: The migration guide is excellent - consider automating similar documentation for future releases.

Follow-up Tasks

The PR correctly identifies post-release tasks:

  • Integration sub-module version bumps (requires v1.14.0 tag first)
  • VS Code marketplace publish (automated via workflow)
  • Glama registry sync (automated)

Recommendation: MERGE

This PR demonstrates exemplary release preparation practices. The comprehensive testing, documentation updates, and attention to detail across all shipping surfaces make this ready for merge and release tagging.

Risk Level: Very Low

  • No breaking changes
  • Drop-in upgrade compatibility
  • Comprehensive verification completed
  • Security issues addressed

Job Run

@ajitpratap0 ajitpratap0 merged commit be25753 into main Apr 11, 2026
21 checks passed
ajitpratap0 pushed a commit that referenced this pull request Apr 11, 2026
Bumps integration sub-modules to track the v1.14.0 release tag:

- integrations/opentelemetry: GoSQLX v1.13.0 -> v1.14.0
  Also bumps otel SDK v1.42.0 -> v1.43.0 (CVE-2026-39883 fix)
- integrations/gorm: GoSQLX v1.13.0 -> v1.14.0

Both sub-modules use replace directives pointing at ../../ so the
version pin only affects published module consumers. Tests pass:
- integrations/opentelemetry: go test -race -timeout 60s (PASS)
- integrations/gorm: go test -race -timeout 60s (PASS)

Follow-up to #508 (v1.14.0 release prep).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
ajitpratap0 added a commit that referenced this pull request Apr 11, 2026
Bumps integration sub-modules to track the v1.14.0 release tag:

- integrations/opentelemetry: GoSQLX v1.13.0 -> v1.14.0
  Also bumps otel SDK v1.42.0 -> v1.43.0 (CVE-2026-39883 fix)
- integrations/gorm: GoSQLX v1.13.0 -> v1.14.0

Both sub-modules use replace directives pointing at ../../ so the
version pin only affects published module consumers. Tests pass:
- integrations/opentelemetry: go test -race -timeout 60s (PASS)
- integrations/gorm: go test -race -timeout 60s (PASS)

Follow-up to #508 (v1.14.0 release prep).

Co-authored-by: Ajit Pratap Singh <ajitpratapsingh@Ajits-Mac-mini-2655.local>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cli documentation Improvements or additions to documentation parser performance python wasm WebAssembly playground

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] multiple errors in ClickHouse dialect [FEATURE] Dialect aware transform package implementation

1 participant